home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-01 / wtek0693.zip / OOPALLEY.ZIP / README.TXT < prev    next >
Text File  |  1993-04-29  |  4KB  |  120 lines
  1. 4/29/93
  2.  
  3. Windows Tech Journal
  4. OOP Alley, June 1993
  5. A Sure Cure for YALL
  6. Greg Voss
  7.  
  8. Introduction to Collections in C++
  9.  
  10.   o Source code for DiskTutor/NIH 
  11.     collection class library
  12.   o Example programs from June Listings
  13.   o Verification suite
  14.        
  15.  
  16. Usage Notes
  17. ===========
  18. Recommended root directory: c:\dt
  19. Use pkunzip with -d option
  20. Compiled with BC++ 3.1
  21.  
  22.  
  23. This is a quick and dirty distribution of
  24. the collection class library discussed in
  25. the June '93 column.  This library 
  26. is basically Keith Gorlen's original
  27. NIH class library scaled down to fit
  28. comfortably within a DOS small memory
  29. model.  It has also been simplified with
  30. an eye toward teaching collection classes
  31. rather than taking the everthing-but-the-
  32. kitchen-sink approach.
  33.  
  34. The original version of the DiskTutor class library
  35. was compiled with Turbo C++ 2.0 in June of 1990
  36. and was distributed with Turbo C++ DiskTutor--
  37. a book that came packaged with a streamlined version
  38. of Borland's C++ compiler.  Revisions were made to
  39. make the code compatible with the more strict error
  40. checking implemented by BC++ 3.1.  Large model
  41. compilation has not been tested since June 1990.
  42. There are some tricky issues for large model
  43. compilation dealing with pointers
  44. (see dtlib\oopsconf.h).
  45.  
  46. The header files are pretty clean, but some of the
  47. source files are pretty ugly.  That will be fixed
  48. shortly.  Next month's OOP Alley also uses the
  49. same class library and by then it will be cleaned
  50. up and modified to compile with MSC 7.0.
  51.  
  52. The current version compiles without generating
  53. warning messages or errors.  There are three
  54. basic directories you need to deal with:
  55.  
  56.     dt\dtlib        library source
  57.     dt\june93       OOP Alley Listings for June '93
  58.     dt\dtlibv       verification suite
  59.  
  60. You don't need to work with the verification 
  61. directory.  It's just there to be sure that the
  62. library has been properly compiled and installed.
  63.              
  64.  
  65. Building the Library
  66. ====================
  67.  
  68.     1. Change to library directory
  69.         >cd dtlib
  70.     2. Compile  
  71.         >make
  72.     3. Install
  73.         >make install
  74.  
  75. The last step will copy the header files to
  76. ../include and copy dt.lib (created in step 2
  77. above) to ../lib
  78.  
  79.  
  80. Compiling Examples
  81. ==================
  82.  
  83.     1. Change to example directory
  84.         >cd june93
  85.     2. Compile examples
  86.         >make
  87.  
  88.  
  89. Notes on Verification Suite
  90. ===========================
  91.  
  92. The programs in dtlibv automate verification of the library.
  93. Only a fraction of the methods are actually tested, but
  94. you can get an idea if something is grossly wrong with
  95. the library by running the verification suite.
  96.  
  97. Unfortunately most DOS users will not be able to run
  98. the automated suite (though you can run any of the
  99. test files manually).  This is because some UNIX pipes
  100. and filters are required to completely automate the
  101. testing.  Namely you need a version of diff that
  102. accepts a '-' as its first argument, indicating that
  103. the standard input piped to diff is to be used
  104. in place of the file normally specified by the
  105. first argument.  I'm working on making the test
  106. suite run automatically under DOS.  I have public
  107. domain source for diff.c which is 90% of the battle.
  108. The rest involves minor modification of the 
  109. makefile.  Even if you don't have a UNIX shell,
  110. you can compile the test suite programs and get
  111. a sense how the automated suite works by looking
  112. at the 'verify' target in the makefile.
  113.  
  114. Hopefully the automated DOS versionn of the test
  115. suite will be distributed with OOP Alley code for
  116. July.    
  117.  
  118.  
  119. Happy OOPing  -gmv
  120.